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Technical Field 

This invention relates to managing multiple web servers, and more particularly to a web 
service system that allows a system operator to distribute content to each web server in the web 
service system. 



In a computer network environment, web servers are used to respond to users' web page 
requests, which are transmitted over the computer network. Web page requests, also referred to 
as content requests, typically are made by a browser running on a user's computer. A web server 
monitors one or more computer network address/port endpoints for web page requests and 
responds to the web page requests by transmitting web pages to the requester. Web servers may 
be special purpose devices, or they may be implemented with a software program running on a 
general purpose computer. The service capacity of a web server limits the number of web page 
requests that may be received and responded to in a given time interval. 

A web service system may include one web server or more than one web server. 



Background Information 
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Generally, when a web service system includes more than one web server, the web service 
system is designed so that the multiple web servers each respond to web page requests. 
Typically, a user's web page request is directed towards one of the web servers, and that web 
server responds to that web page request. It is also typical for web service systems designed to 
5 receive a large number of web page requests to include many web servers. 

In general, in a system with multiple web servers, a system operator or operators manage 
the content offered by the various web servers. A system operator may sometimes wish to 
coordinate the content on the system, for example, to make sure that the content on various web 
servers is identical, or to have some content available from one web server and other content 
10 available from another web server. This can be difficult to accomplish, especially if content 

updates are to be transparent to users, who can potentially be in the middle of an interaction with 
the system involving a series of related web pages. 
□ Managing content is also a problem for caching servers. Caching servers "cache", or 

i 7 j temporarily store, the results of requests relayed from a browser to a web server for use in 
;:: ;i5 satisfying subsequent identical requests. A challenge in caching server design and operation is 
£5 determining when the stored (cached) content is no longer co nsistent wit h the conte nt on the 
hi original server, that is, when the cached content is invalid. The hypertext transfer protocol 
% % ("http") ►jncludes^^chanism for the origina l server of so me content to specify thej iuration for 
1 w hich a cache server should retain a co py^oftfie content. For some content, however, it is not 
i j20 possible for the original server to accurately determine in advance how long the content will 
H j remain valid, and there may be times when content is unexpectedly updated sooner than the 
expiration time specified by the original server. 



Summary of the Invention 

25 In a web service system with one or many web servers, a system and method for 

managing and distributing the content on the one or more web servers is useful to a system 
operator. For example, content updates are often desired to be performed on a rapid basis. 
Scheduling and automation can be used to update content on the servers in an efficient and 
consistent manner. Also, it is helpful to identify content update failures, take a failed server out 

30 of service, fix it, and return it to service in the web service system as quickly as possible. It is 



desired to maximize web site availability, even as updates occur, while minimizing disruption of 
transactions. Changes may require that a server be restarted, for example if the content is served 
using a shared library that will not be unloaded (and/or updated) until the web server process(es) 
exit. 

A web service system according to the invention correctly and efficiently updates 
changed content on the one or more web servers in the system, so that the changes are consistent 
among the web servers and so that the changes do not require excessive network bandwidth. 
This is accomplished such that the content change is not noticeable to a browser engaged in a 
transaction with a web server, and so that content versions are preserved, both for consistency of 
transactions started using older content, and so that a web server can revert to the older content if 
there is a problem with an update. A web service system of the invention also can track content 
changes, and notify caching servers as appropriate that cached content has become invalid. 

In general, in one aspect, the invention relates to a system and method for notifying a 



computer of changed files. Changes in a source file set are identified. The identified changes are 



stored in a modification list including uniform resource locators specifying the changed files. 



The modification list is transmitted to a computer. In one embodiment, the modification list is 
transmitted to a web cache server. In one embodiment, the changes are identified by inspecting a 
set of files and comparing the set of files to an e arlier-recorded se t. In another embodiment, the 
files set is compared to an earlier-recorded set by comparing a file attribute to the file attribute of 
the earlier-recorded set. In another embodiment, the file attribute comprises at least one attribute 
chosen from the set of file size, file permissions, file ownership, modification time, and a hash of 
the file. In another embodiment, the changes are identified by inspecting a set of files and 
comparing the set of files to an earlier-recorded set. In another embodiment, the changes are 
identified by installing^deyice^driver to perform file operations and by recording, by the device 
driver, changes to the source file set. In another embodiment, the changes are identified by 
receiving a manifest describing changes to the source file set. In another embodiment, the 
method includes, before the identifying step, the step of calling a script. In another embodiment, 
the method includes, before the transmitting step, the step of calling a script. In another 
embodiment, the method includes, after the transmitting step, the step of calling a script. In 
another embodiment, the method includes, the step of determining whether the transmitting step 




has successfully completed, and wherein the calling step occurs after the determining step. 

In general, in another aspect, the invention relates to a system and method for replicating 
changes in a source file set on a destination file system and for notifying a computer of the 
changes. Changes in a source file set are identified. The changes are stored in a first 
5 modification list. The modification list is transmitted to an agent having access to a destination 
file system. The changes are stored in a second modification list comprising uniform resource 
locators specifying the changed files. The modification list is transmitted to a computer. In one 
embodiment, the modification list is transmitted to a web cache server. In another embodiment, 
the first modification list^^ is converted into the second modification list. 
10 In general, in another aspect, the invention relates to a system and method for replicating 

changes in a source file set on a destination file system and for notifying a computer of the 
changes. Changes in a source file set are identified. The changes are stored in a second 
Q modification list comprising uniform resource locators specifying the changed files. The 
lil modification list is transmitted to an agent having access to a destination file system. The 
; ::i5 modification list is transmitted to a computer. 

|«J In general, in another aspect, the invention relates to a web service system. The system 

'\j includes a manager for managing the web service system. The system also includes a host 
p % including a web server for receiving web page requests and an agent in communication with the 
^ manager. The system also includes a web cache, and a content distributor for providing content 
U20 changes to the host. In one embodiment, the content distributor notifies the web cache of content 
changes. In another embodiment, the system includes an traffic manager for directing web page 
requests. In another embodiment, the content distributor includes an identification module for 
identifying changes in a source file set, a modification list for storing identified changes, and a 
transmitter for transmitting the modification list to an agent having access to a destination file 
25 system. In another embodiment, the system includes a transmitter for transmitting the changed 
files to the agent. In another embodiment, the agent includes an installer for installed the 
changed files on the destination file system. 

In general, in another aspect, the invention relates to a content distributor. The content 
distributor includes an identification module for identifying changes in a source file set. The 
30 content distributor also includes a modification list for storing identified changes. The content 



# • 



distributor also includes a transmitter for transmitting the modification list to an agent having 
access to a destination file system. In one embodiment, the content distributor includes a 
transmitter for transmitting the changed files to the agent. In another embodiment, the content 
distributor includes a transmitter for transmitting the changed files to a web cache server. 
5 The foregoing and other objects, aspects, features, and advantages of the invention will 

become more apparent from the following description. 

Brief Description of the Drawings 
In the drawings, like reference characters generally refer to the same parts throughout the 
10 different views. Also, the drawings are not necessarily to scale, emphasis instead generally being 
placed upon illustrating the principles of the invention. 

FIG. 1 is a block diagram of an embodiment of a web service system according to the 
q invention. 

Tfi FIG. 2 is more detailed block diagram of an embodiment of a web service system. 

Ms FIG. 3 is a flowchart of the operation of an embodiment of the content distributor of FIG. 



C] FIG. 4 is a flowchart of a comparison of the current source file set and a previous file set. 

!!; sa FIG. 5 is an embodiment of a manifest entry, 

u) FIG. 6 is an example list of changed files. 

! j?0 FIG. 7 is an example embodiment of a manifest showing the changed files of FIG. 6. 

FIG. 8 is an example of an embodiment of old version maintenance. 
FIG. 9 is a block diagram of an embodiment of a web service system in communication 
with a caching server. 

FIG. 10 is a flowchart of an embodiment of a method for distributing content. 
25 FIG. 1 1 is a flowchart of the operation of another embodiment of the content distributor. 

FIG. 12 is a flowchart of the operation of another embodiment of the content distributor. 
FIG. 13 is an example of the information provided to a script in the embodiment of FIG 

12. 



Description 

A system for serving web pages has a plurality of web servers and provides a system 
operator with features and tools to coordinate the operation of multiple web servers. The system 
might have only one web server, but typically it includes more than one. The system can manage 
5 traffic by directing web page requests, which originate, generally, from web browsers on client 
computers, to available web servers, thus balancing the web page request service load among the 
multiple servers. The system can collect data on web page requests and web server responses to 
those web page requests, and provides reporting of the data as well as automatic and manual 
analysis tools. The system can monitor for specific events, and can act automatically upon the 
10 occurrence of such events. The events include predictions or thresholds that indicate impending 
system problems. The system can include crisis management capability to provide automatic 
error recovery, and to guide a system operator through the possible actions that can be taken to 
i: ;;f recover from events such as component failure or network environment problems. The system 
UJ can present current information about the system operation to a system operator. The system can 
I : |5 manage content replication with version control and data updates. Some or all of this 
i ,! f functionality can be provided in specific embodiments. 

S J Referring to FIG. 1 , an embodiment of a web service system 90 receives web page 

Q requests from a browser 1 . In this context, a web page is electronic content that can be made 

available on a computer network 2 in response to a web page request. Requests typically 
'120 originate from web browsers 1 . An example of a web page is a data file that includes computer 
;.];! executable or interpretable information, graphics, sound, text, and/or video, that can be 

displayed, executed, played, processed, streamed, and/or stored and that can contain links, or 
pointers, to other web pages. The requests are communicated across a communications network 
2. In one embodiment, the communications network 2 is an intranet. In another embodiment, 
25 the communications network 2 is the global communications network known as the Internet. A 
browser 1 can be operated by users to make web page requests. Browsers 1 can also be operated 
by a computer or computer program, and make requests automatically based on the computer's 
programming. The web page requests can be made using hypertext transfer protocol ("http") 
format, and also can be made using other protocols that provide request capability. 
30 Referring to FIG. 2, an embodiment of a web service system 90, includes various 
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components 100-126. The components communicate over one or more computer networks. The 
physical location of the components does not impact the capability or the performance of the 
system, as long as the communications links between the various components have sufficient 
data communication capability. The web service system 90 can function across firewalls of 
5 various designs, and can be configured and administered remotely. 

The web service system 90 manages one or more hosts 100. One host 100 is shown as an 
example. An embodiment of the web service system 90 can have any number of hosts 100. 
Each host 100 can be a computer system commercially available and capable of using a multi- 
threaded operating system such as UNIX or Windows NT. Each host 100 can have at least one 
10 network connection to a computer network, for example the Internet or an intranet, or any other 
network, that allows the host 100 to provide web page data in response to web page data 
requests. Each host 100 includes at least one web server 102. 
1 <«i The web server 102 can be any web server that serves web pages in response to web page 

y requests received over a computer network. Two examples of such web servers are 
i: ::jl5 commercially available as the NETSCAPE ENTERPRISE SERVER, available from Netscape 
pj Communications Corporation of Mountain View, California and the MICROSOFT INTERNET 
M INFORMATION SERVICES SERVER, available from Microsoft Corporation of Redmond, 
□ Washington. The web server 102 is capable of receiving web page requests from web clients, 
! : "f also referred to as browsers and/or web page requesters. A web page request from a browser is 
;];20 also referred to as a content request, or from the point of view of a web server, as a "hit." Often 
j\ the web page requests are part of a series of communications with the web server 102 involving 
several requests and responses. One such series, referred to as a session, is an extended 
interaction with the web server. A shorter interaction, for example the purchase of an item, is 
referred to as a transaction. A session could involve several transactions. The user interacts with 
25 a web server 102 by making an initial request of the web server 102, which results in the web 
server 102 sending a web page in response. The web page can contain information, and also 
pointers to other requests that the user can make of the web server 102 or perhaps other web 
servers. Sometimes the requests are for information that must be retrieved from a database, and 
sometimes the request includes information to be stored in a database. Sometimes the request 
30 requires processing by the web server 102, or interaction with another computer system. 




Sophisticated web servers and browsers can interact in various ways. 

An aggregation of related web pages presented to a user as a set of web pages about a 
related topic, or from a particular source, usually, but not always from the same web server 102, 
is referred to as an application. One example of an application is a set of pages providing 
5 information about a company. Another example of an application is a series of pages that allow 
a user to conduct transactions with her savings bank. Two sets of web pages may be considered 
a single application, or they can be considered two separate applications. For example, a set of 
web pages might provide information about a bank, and a customer service set of web pages 
might allow transaction of business with the bank. Whether a set of web pages is considered to 
10 be one application or several applications is a decision made by the application designer. The 
web service system 90 is capable of delivering one or more applications to users. The web 
service system 90 can be configured so that some subset of the web servers 102 exclusively serve 
J a single application. In one embodiment, some web servers 102 serve a subset of the available 
\j\ applications, and other web servers 102 serve other applications. In another embodiment, all 
i vis web servers 102 serve all available applications. 

! !sJ The web pages that are presented to the user in response to web page requests from the 

%j user's web browser can be stored on the host 100 or on a file system accessible to the web server 
f-\ 102. Some or all of the web page content can be generated by the web server 102 by processing 
! ,?! f data available to the web server 102. For example, for web pages that are documents about a 
iilSO topic, the web pages can be created (designed) and stored in the web server 102 file system. In 
response to a web page request, such a web page can be sent to the user just as it is stored in the 
file system. In a banking transaction system, however, it is likely that information about the 
user's bank account will be stored in a database. The web server 102 can generate a web page 
containing the user's account information each time the user requests the page. Often, web pages 
25 are stored partially in the file system, and partly are generated by the web server 102 when the 
request is made. 

Various techniques are used to store status information, also referred to as the "state" of a 
user's session with the web server 102. The user can develop a state during her interaction with 
the web server 102 via the requests made to the web server 102 and the web pages received in 
30 response to those requests. The user's state can, as one example, include information identifying 



the user. As another example, the state can include information specifying web pages the user 
has already requested, or the options the user has selected in her interaction with the system. As 
another example, the state can include items the user has selected for purchase from a 
commercial sales application. Generally some information about or identifying the state of the 
5 session is stored in the client web browser, for example as a cookie as described below, and some 
information can be stored in the web server 102. 

A host 100 can have any number of web servers 102 running on it, depending on host 
capacity, performance, and cost considerations. In one embodiment, the host 100 includes one 
web server 102. In other embodiments, a host includes more than one web server 102. The one 
10 web server 102 on host 100 is a simplified illustrative example and are not intended to limit the 
number of possible web servers 102. Each web server 102 monitors at least one network address 
and port, also referred to as an endpoint. A particular address and port is called an endpoint 

□ because it is a virtual endpoint for communication — a network connection is made between one 
Uj address/port endpoint and another. A web server 102 receives requests directed to one of its 
|: ^15 endpoints and responds to those requests with data in the form of web pages. 

□ A web server 102 that accepts requests at multiple network address/port endpoints can 
K\ perform as if it were a plurality of distinct web servers 102 even though it is actually 

jIU implemented as one web server 102. Such a web server is referred to as a multiple endpoint web 
p server. For the purposes of this discussion, a multiple endpoint web server can be described as if 
ij:20 it were in fact multiple web servers 102 with each web server 102 receiving requests on a 

network address/port endpoint. In one embodiment, such a multiple endpoint web server has one 
web server interface 104 that is the interface for all of the multiple endpoints. 

Each web server 102 can have associated with it a web server interface 104. The web 
server interface can be a plug-in, filter, or other software associated with the web server 102 that 
25 serves as an interface between the web server 102 and other components of web service system 
90. In this context, the term web server interface is distinct from the network interface that can 
be present on the host 100. For example, the web server 102 has a web server interface 104. 
Each web server interface 104 can communicate with an agent 106 on each host 100. 

A host 100 includes an agent 106. The agent 106 provides a web service system 90 
30 interface with the host 100. The agent 106 links the web server interface 104 with the web 
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service system 90. The agent 106 also links the host 100 with the web service system 90. Even 
on a host that has multiple web servers, there is generally only one agent 106 running on the host 
100, however it is possible to have more than one. Each agent 106 has access to a database 108, 
which contains information about the system components. 
5 The agent 106 on a host 100 communicates with a web service system manager 110. The 

manager 110 receives information from the agents 106 about the status of the hosts 100 and the 
web servers 102. The manager 110 can send commands to the agents 106 to configure the hosts 
100, to start, stop, or pause the web servers 102, and to manage the load on the web servers 102. 
The manager 1 10 has access to a logging database 1 14 that is used for logging system activity 
10 and events. The manager 110 also has access to a managed object database 1 12, used for storing 
information about the various components of the system. The manager 1 10 is also in 
communication with one or more consoles 1 16A-1 16X, generally referred to as 1 16. The 
!, ;;f consoles 116 provide a user interface for the system operator. The system operator can monitor 
Lj.J the status of the system and configure the system via a console. The manager 110 can be run on 
?^15 the same host 100 as other web service system 90 components, such as one of the web servers 
: 102 or a traffic manager 120, or on another computer of sufficient capacity. 

'""4 The manager 1 10 communicates with a traffic manager 120, also referred to as an 

p interceptor. The traffic manager 120 directs web page requests to a web server. The invention is 
j 1 ' f not restricted to any particular type of traffic manager 120, but rather is intended to work with 
-20 any sort of traffic manager 120 that directs web page requests to web servers 102. 
;.];*] In one embodiment, the traffic manager 120 receives information and commands from 

the manager 110. The traffic manager 120 also receives information and commands from a 
control program 122. The traffic manager control program can be on the same computer system 
as the traffic manager 120, or alternatively it can run on another system. The traffic manager 120 
25 receives web page requests and refers the requests to one of the web servers. Part of the 

management capability of the web service system 90 is accomplished by monitoring the web 
page requests made of the web servers 102 and the resulting load on the web servers 102 and the 
hosts 100. Web page requests can be directed to balance the load among the web servers 102. In 
one embodiment, the traffic manager 120 is the point of first contact for a user. The traffic 
30 manager 120 receives a web page request from a user and "refers" the user's web browser to an 
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appropriate web server 102 for that request. The user's web browser is referred by responding to 
the web page request with a referral to a web page on an appropriate web server 102. This 
referral capability can be accomplished with a capability incorporated into the hypertext transfer 
protocol, but can also be accomplished in other ways. The user may or may not be aware that the 
5 web browser has been referred to an appropriate web server 102. The user accesses the 

application on that web server 102 and receives responses to its web page request from that web 
server 102. In one embodiment, if a web server 102 becomes overloaded, that web server 102, 
under the direction of the manager 1 10, can refer the user back to the traffic manager 120 or to 
another web server 102 capable of delivering the application. 
10 The traffic manager 120 receives requests from users and redirects the user's requests to 

web servers 102. In one embodiment, the traffic manager 120 is used to direct all users to one 
web server 102, such as another traffic manager 120 or a single endpoint. In this manner, the 
□ traffic manager 120 acts as a shunt, meaning it directs all requests directed towards one or more 
h i web servers on a host to another web server 102. In another embodiment, the traffic manager 
35 120 receives status information from the manager 110 and uses that information to redirect users. 
Q The status information includes server availability and load, administrator's changes, and 

Li 

application or web server 102 start and shut down actions. The traffic manager 120 is designed 
;;L, for speed and security. The traffic manager 120 is often the front door to the system, and so its 
ffJ performance affects the perceived performance of the entire web service system 90. It may be 
i; i;g0 useful to locate the traffic manager 120 as close, in the network topology sense, to the backbone 
^l: as possible. It is then necessarily the most exposed component of the web service system 90. 

In one embodiment, the traffic manager 120 is implemented in hardware. In another 

embodiment, the traffic manager 120 is a software program running on a host computer. In one 

software embodiment, the traffic manager 120 is a standalone program that runs on a server-class 
25 computer capable of running a multi-threaded operating system. Under UNIX, for example, the 

traffic manager 120 can run as a daemon. Under Windows NT™, the traffic manager 120 can 

run as a service. 

In another embodiment, the traffic manager 120 is an internet protocol bridge or router 
that directs requests made to one endpoint to the endpoint belonging to a web server 102. In this 
30 way, the traffic manager 120 directs the web page requests to one or more web servers 102. An 
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example of such a traffic manager is the LOCALDIRECTOR available from Cisco Systems, Inc. 
of San Jose, California. In yet another embodiment, the traffic manager 120 is a web switch, 
such as a CONTENT SMART WEB SWITCH available from Arrowpoint Communications, Inc. 
of Westford, Massachusetts. The traffic manager 120 receives each web page request and, based 
5 on the request, directs the request to a web server. 

The web service system 90 also incj^je^aversion controller, also referred to as a content 
distributor 125. The content distributor 125 manages version and content replication, including 
content updates on the various web servers 102 in the web service system 90. A system operator 
interface to the content distributor 125 is provided by a content control 126. In one embodiment, 
10 the content distributor 125 and the content control 126 are each a stand-alone process that 
operates on the host 100. In another embodiment, the content distributor 125 and the content 
control 126 operate on the same host as the manager 110. In still other embodiments, content 
□ distributor 125 and the content control 126 operate on other hosts. The content distributor 125 
jjj and the content control 126 can operate on the same host, or on a different host. In other 
;M :?15 embodiments, the content distributor 125 is incorporated into the functionality of the manager 
*P 1 10, or other components of the system 90. 

h'l The content distributor 125 transmits information to the agent 106, and through the agent 

106 to the web server interface 104. The transmitted information describes changes to a set of 
l f J content directories and files that are referred to as the soiircejiles, and are generally organized in 
i:]!20 a hierarchical directory structure. These source files are the "master^co py of the content for th e 
j=J web servers. Together, the directories and files are referred to generally as the source files or the 
so urce file set. The source file set can be stored on a source host, also referr ed to as a s taging 
server, which is typically, but not necessarily, the host on which the content distributor \ 25 is 
running. For simplicity of explanation, in the following discussion, content dir ectories an d files, 
25 eit her the source file s or on a host 100, generally are referred to just as files. The source file set 
can include both directories and files, and changes to the files can also include the a dditio n, 
deletion, and modification of directories. 

ReferringYo-FIG. 3, changes are made over some periodofti me to the source file s et 
(STEP 180). The changes that are made include such changes as the creatio n of new fi les, 
30 deletion of old files, replacement of existing files with new content (i.e. modifying file content), 
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and modifying file attributes such as permission restriction and ownership. Again, although 
changes to files are described, it is intended that changes to directories also are included. 
Changes are made by editing the files using such editing techniques and tools known in the art, 
including application programs and operating system utilities. Changes may be tested, and 
5 approved in development and approval process. There may in fact be no changes to the files at a 
particular time, and the system can recognize this. In such cases, after identifying the absence of 
changes, there is no further processing until the next time possible changes would be identified. 

The content distributor identifies the changes to the files (Step 181). Changes to the files 
can be identified in a number of ways. In one embodiment, the content designer provides a 
10 manifest, which is a list of changes. The designer keeps track of the changes, and manually 
identifies the changes to the content distributor, for example using the content control user 
interface 126, or by communicating a manifest to the content distributor 125. In another 

□ embodiment, the software and systems used by the content designer to design the content tracks 
changes and provides a manifest of changes that are communicated to the content distributor 125. 

35 In another embodiment, the content distributor 125 integrates with the operating system 

hi ' 

Q file services and monitors changes to the source file set. In one such embodiment, a software 
\j device driver "monitor" is installed that is invoked by the operating system to perform file 
L operations. The device monitor acts as a pass-through device driver that passes data between the 
B operating system and the actual device driver (i.e. hard disk driver software). In addition to 
:j;gO passing the disk I/O commands through to the disk driver, the device monitor observes those I/O 
commands, and records changes to the source file set. In one embodiment, the device monitor is 
integrated with the content distributor 125. In another embodiment, the device monitor produces 
a manifest that is communicated to the content distributor 125. 

In yet another embodiment, the content distributor 125 performs a comparison between a 
25 current source file set and a previous source file set to determine the changes to the source file 
set. The content distributor maintains a list of the files that were present the last time that an 
update was made for comparison purposes. This list includes the file name and other file 
properties, such as the file size, the date/time that the file was last modified, a hash code of the 
contents, the permissions and/or access control restrictions, and user/group ownership. In one 
30 embodiment, the list of files includes a complete copy of every file in the previous source file set, 



however, for large file systems this embodiment is very inefficient. In a more efficient 
embodiment, only a list of the previous files and certain file attributes are needed, as described 
below. The steps of identifying changes (STEP 181), transmitting changes (STEP 182), and 
installing the changes (STEP 183), are sometimes referred to as an update. 
5 Referring to FIG. 4, in one embodiment, the comparison between the source file set and 

the previous file set takes place by analysis of the files (and directories) in the source file set. For 
each file in the source file set (STEP 190), the content distributor compares the files in the source 
file set with the information describing the previous source file set, which in one embodiment is 
in the form of a list as described above. For each file, the content distributor determines if the 
10 file is in the previous source file set list (STEP 191). If it is not, the file is listed as a new file 
(STEP 192), indicating that the file has been added to the source file set, and a hash is calculated 
on the file (STEP 193). If the file is listed, the file listing is marked (STEP 194) to indicate that 

u the file is still included in the file set. This is later used to determine if any files on the previous 

i j list are missing, that is whether they have been deleted. 

. 35 The size of the file is compared to the information in the list (STEP 195). If the file size 

is different, the file is considered to be modified, and is listed as such (STEP 196). A new hash 
\j of the file is calculated and stored in the list (STEP 193). If the size is the same, the date/time is 

compared (STEP 197). If the date/time is different, the hash of the file is calculated and 
pJ compared to the hash included in the previous list (STEP 198). In this context, a hash is a 
■ j;20 calculation made on the content of the file that results in a single number that is related to the file 
% content. Such a hash is also referred to as a message integrity code. Examples of hash codes are 
checksums and a cyclic redundancy codes. If the hash of a file is different, the file is listed as 
modified (STEP 196), and the new hash is stored (STEP 193) in the list. Otherwise, if the file 
attributes (owner, group, etc.) have changed (STEP 199), the file is listed as having modified 
25 attributes (STEP 200). 

In one embodiment, if the file contents have not changed, the system also determines 
whether file attributes changed (Step 199). In another embodiment, attribute information is sent 
as a part of the content update. When these steps have been completed for all files in the source 
file set, markings from STEP 194 are checked to see if any files that were previously listed are 
30 now missing, meaning that they have been deleted from the file set (STEP 200). Files not 
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marked are listed as deleted (STEP 202). 

Changes to the source file set are identified to the content distributor 125 in a change list, 
also referred to as a manifest. In one embodiment, the manifest contains entries that indicate 
changes to a file such as additions, deletions, content modifications, and/or attribute 
5 modifications. For example, the add statement "ADD source/dir/dir/filel" indicates that a file 
filel has been added, and the statement "CHMOD source/file2" indicates that permissions 
associated with file "file2" have changed. Other statements include "DELETE" to indicate 
removal of a file, and "MODIFY" to indicate a change of content. Additional attribute 
differences also use the CHMOD statement, or might have specific statements of their own, such 
10 as CHOWN for a change of ownership, or CHGRP for a change of group association. 

Referring to FIG. 5, in one embodiment, a manifest entry 300 includes at least eight 
information elements 301-308. In one embodiment, each entry is stored in a text format, so that 
Q the information can be read by a system operator with a simple text editor or interpreted by other 
j7j software. In another embodiment, each entry is stored in binary format that contains the same 
35 information as in the text format, but is more compact. The binary format can be converted with 
.□ a conversion tool to the text format. The text format can also be converted to a binary format. 
h t \ In one embodiment, the manifest entry 300 includes a file type field 301 . Possible file 

£ l% types are directory, file, symbolic link, hard link, or end-of-directory marker, which comes after 
Oil the last file in a directory. In a text embodiment, each file is described with a three letter code 



j for a symbolic link, and "HLK" for a hard link. In a binary embodiment, each choice is 

represented by an integer code. For example, in one embodiment, a directory is represented by 
the number 1, and a file is represented by a 2, and so on. 

The manifest entry 300 also includes an action taken field 302. In the text embodiment, 

25 the action taken is a three letter code, such as "ADD" for an added file, "CHG" for changed 
content, "CHP" for changed owner, group, or permissions, and "DEL" for a deleted file. The 
three letter code "NOC" is used to describe a file that has not changed. In a binary embodiment, 
each choice is represented by an integer code. For example, in one embodiment, an added file is 
represented by the number 1, a changed content is represented by a 2, and so on. 

30 The manifest entry 300 also includes a permission field 303, which describes the file 
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such as "DIR" for directory, "END" for end-of-directory marker, "NRM" for normal file, "LNK' 




access permissions, as well as other information about the file. In a text embodiment, the 
permissions are stored, UNIX-style, as four 3-item binary entries (i.e. nvxrwxrwx), where the 
first 3-item entry describes whether an executable program will run as the user, and the following 
three entries show read, write, and execute permissions for the owner, group, and public, 
5 respectively. In a binary embodiment, the permission information is stored as a binary integer 
that is the four-digit octal number that represents the permissions. 

The manifest entry 300 also includes a file size field 304, which describes the size of the 
file. In a text embodiment, the file size is written in ASCII characters. In a binary embodiment, 
the file size is stored as an integer. 
10 The manifest entry 300 also includes a date/timestamp 305. In a text embodiment, the 

date and time are written in ASCII characters. In a binary embodiment, the date/time is stored as 
an integer representing the number of seconds since midnight January 1, 1970. 
□ The manifest entry 300 also includes ownership information 306. This information 

|7j includes two parts — the user identifier of the file owner, and the group identifier of the group 
: 35 owner. In a text embodiment, the owner and group identifiers are stored as ASCII strings. In a 
'Q binary embodiment, the owner identifier and group identifier are each stored as integers, 
ihj The manifest entry 300 also includes a checksum 307 or hash result. In a text 

L embodiment, this is stored as an ASCII string. In a binary embodiment, the checksum is stored 
01 as an integer. The manifest entry also includes the relative path name 308 of the file. In both 
ij;20 text and binary embodiments, the relative path name 308 is stored as an ASCII string. 

Referring to FIG. 6, an example list of changes shows added files aaa (which is a 
directory), files agent.reg, questd.reg, and sqlserver.reg in directory aaa, and files bbb and ccc, 
which are also directories. Directory ddd, and files abc and efg in directory ddd are unchanged. 
Directory efg is also unchanged. Directories mmm, xxx, and yyy are deleted, and files agent.reg, 
25 questd.reg, and sqlserver.reg are deleted from directory xxx. 

Referring to FIG. 7, an example of a text embodiment of a manifest of the format of 
FIG. 5 reflects the changes listed in FIG. 6. In the first entry, ENTRY 1, the directory aaa is 
listed in the file name 308. The file aaa is listed as type 301 "DIR." The action 302 for this file 
is "ADD," indicating that the file was added. The permissions 303 are listed UNIX-style, and 
30 show that the file is a directory, and that the owner has read, write, and execute permissions. The 




file size 304 is listed as zero. The date/timestamp 305 of the file is listed as May 27 17:12. The 
user and group identifiers 306 are both listed as identifier 0. The checksum of the file 307 is 
zero. 

In the second entry, ENTRY 2, the file listed in the file name 308 is agent. reg. This file, 
5 agent.reg. Because ENTRY 2 is between the aaa directory entry (ENTRY 1) and the END 

statement (ENTRY 5), this file is in directory aaa. The file agent.reg is of type 301 normal, and 
was added as new file, as shown in the action element 302. The permissions 303 indicate that the 
owner has read and write permission. The file size 304 is 569 bytes. The date 305 of the file is 
May 11, 1998. The user and group identifiers 306 are both zero. The checksum 307 is 
10 3564886220. 

The fifth entry, ENTRY 5, is of type 301 END marker, which indicates the end of listings 
for directory aaa. The sixth entry, ENTRY 6, directory bbb is not a subdirectory of aaa, because 
t;!i it is listed after the aaa END marker. 

i , j Referring again to FIG. 3, in one embodiment, the content distributor creates the 

^15 manifest, for example by determining the changes using the method of FIG. 4. In another 
u embodiment, the manifest is communicated to the content distributor. In one embodiment, the 
Ki manifest is communicated by storing the manifest in a particular location (i.e. directory and 
jlU filename), where the content distributor is configured to find it. In another embodiment, the 
*p manifest is communicated to the content distributor by explicitly transmitting it to the content 
U:g0 distributor 125 over a network. 

After the changes have been identified (STEP 181), for example using the embodiment of 
FIG. 3, the changes are transmitted to the agent (STEP 182). Often, the changes are mapped to a 
particular directory on the host file system. In one embodiment, the source file set is mapped to 
the various hosts' file systems as shown in the example in Table 1 : 

25 



Source Host 


Source Directory 


Destination Host 


Destination Directory 


staging.atreve.com 


/usr/netscape/docs/app 1 


www 1 .atreve.com 


/usr/netscape/docs/app 1 






www2.atreve.com 


/docs/current/app 1 






www3 .atreve.com 


/usr/netscape/docs/al 


Table 1-1 


example Mapping of Source Directory to Destination Host Directory 



As can be seen from Table 1, the system administrator can map the files in the source file set 
from the staging server file system to the file systems on the various web servers. Use of the 
actual file systemjdentifier, and not a URL, allows mappings of shared libraries and other files 



5 that may not be identifiable with a Uniform Resource Locator ("URL"). For example CGI 

scripts might not be mapped if a URL was used since such files generally are not available from 
the web server via web page requests, and so do not have a URL. It would be possible to use the 
URL instead of the file system identifier, so that the mapping is not necessary, but at the tradeoff 



of restricting the type of files that can be modified. If URLs were used, only files that were 
10 accessible from the web server via web page requests would be accessible. 

In one embodiment, the files in a source file set directory hierarchy are combined into a 
single archive file, and that archive file is compressed. Any file that is larger than a configurable 
'Q value is divided into smaller blocks for more efficient communication across the network to the 
| ; j host systems and to reduce the impact on the network. Dividing the files into smaller blocks 
; v l5 minimizes the amount of retransmission in case of a timeout. An example of such a configurable 
□ value is one megabyte. 

%i A change list (manifest), including the file sizes of the changed files is sent to each agent 

that is to receive the content. The agent determines whether there is sufficient disk space for the 
update, based on the file sizes in the change list and the computation the agent knows it will need 
iJ;20 to perform. For example, the agent may determine whether there is enough room within the file 
'!% system to store the compressed copy of the content updates, and two copies of the uncompressed 
data, a temporary copy and the copy to be stored. In this way, the agent is able to abort transfer 
before the host has become overloaded with the new content. 



25 data is sent from the content distributor to the agents. If too many agents are unable to receive 
the content, the content distributor may abort the job. The percentage of agents required for a 
transfer to take place is configurable. For example, the system operator may determine that the 
transfer should not take place unless 50% of the agents are able to accept the changes. It is 
possible in this way to prevent having too few servers that have the updated content. 

30 In one embodiment, transfer occurs using a standard TCP/IP transport, such as file 





When a predetermined number of servers have agreed to receive the updated content, the 



transfer protocol ("FTP"). In another embodiment, transfer occurs using a reliable multicast 
protocol. If there are transmission failures, a block of data is resent. If the transfer fails 
repeatedly, the transfer is aborted, and various action can be taken including alerting the system 
operator. Again, the content distributor may abort the installation of the changes if due, to 
5 unforeseen circumstances, fewer agents succeeded at the transfer than were expected to. If, for 
example, many of the agents lose network connectivity, it would be possible to have an 
insufficient number of agents available to serve the new content. 

Referring again to FIG. 1, if an update fails for a particular agent 106, the web service 
system 90, will attempt to "route around" the affected part of the system. In an embodiment 
10 where the content distributor is separate from the manager, the content distributor 125 informs 
the manager 110 that the agent 106 has failed. The manager 110 communicates with the traffic 
manager 120, so that the traffic manager will not direct web page requests to the web servers 102 
□ communicating with that agent 106. The manager 1 10 may also direct traffic away from the web 
;7i servers 102 onto other servers. 

3 5 In one embodiment, the content distributor 125 will create a "catch-up" update package 

E) targeted to the failed destination agent. The catch-up update package contains the changes that 
hi should have, but have not, reached the agent; initially, this is the list of changes from the first 
update to fail in transmission. This catch-up update package may grow if subsequent updates 
SI also fail to reach the same agent. When an update package fails, the agent will not receive other 
: r20 updates until a "catch-up" update completes, because there may be dependencies from new 
updates on changes which earlier failed to propagate. 

Referring again to FIG. 3, once the changes have been transmitted to the agent 182, the 
changes are installed (STEP 183). The agent 106 and the web server interface 104 cooperate to 
install the content. When the new content has been received, the agents reassemble, and then 
25 uncompress, the update packages, and place the data in a temporary data store. The agents then 
wait for a signal from the content distributor to begin copying the files to the server content 
directories. When the signal is received, the changes are made to the server content directories. 
Also, any files listed for deletion are removed at this time. When the update is successful, the 
agents inform the cont ent d ist ribut or that they have suc ceedgdjn updating j^gfiles. In one 
30 embodiment, the copying is accomplished with a simple overwrite. In another embodiment, the 




old files are first renamed and/or stored in an alternate directory. This allows the change to be 
quickly reversed, but with the tradeoff of requiring more data storage. If copying fails for any 
reason, the agents will alert the content distributor of the problem. Either the agent or the content 
distributor will also alert the Manager, which may then instruct the traffic manager to avoid the 
5 failed agent. In one embodiment, the agents maintain a version identifier, which indicates the 
content state of the web server. In one embodiment, the version identifier is an integer value. 

In one embodiment, the web server is paused or stopped during the update process. 
When the files are copied to the web server content directories, the web servers are prevented 
from handing web page requests in order to prevent requesters from receiving inconsistent 
10 content. The web servers are coordinated to redirect users during the content update process. 
This is accomplished by the manager directing the traffic manager not to forward requests to that 
web server. At the same time, requests which do reach that web server 102 may be redirected by 
the web server interface 104 from that web server 102 to the traffic manager 120 or to another 
I" j web server 102. Users in the middle of a transaction may be given a predetermined amount of 
;;i5 time to complete the transaction before being redirected. Once the web server has been flushed 
□ of requesters, the update will take place. If application binary files are not being changed, the 
-\j web server can be flushed of requesters, and then requesters can be directed to the server once the 

content transfer is complete. If application binary files are modified, however the web server 
HI may need to be restarted. 

ij gO In some cases, it may not be possible to disable web servers in order to update content. 

: ;% The process of temporarily redirecting the browsers can be very time consuming, and that time, 
combined with the time required to transfer files and update the web server can be unacceptably 
large. To maximize server availability, the content can be updated while the web server 
continues to respond to requests. This is achieved by creating a copy of the files that will be 
25 changed, and putting the copy of those files in a place accessible to the web server. The agent 
directs the web server interface to intercept all requests for files that are changing. Requests for 
files that are not changing can be directed to the usual content area. Requests for files that are 
changing can instead be directed to the stable copy, while the new files are installed in the usual 
area. After the agent has completed modifications to the files, the web server interface can be 
30 signaled to again use the normal area. Users who, at the time of switchover from the old to the 



new content, are involved in a transaction that involves a series of related web pages may need to 
continue to access the "old" content for some time after the switchover, until the transaction is 
complete. For example, a user in the middle of a purchase at a first price should not complete the 
transaction with a web page that is using an updated, different price. 
5 In one embodiment, to ensure transaction integrity, each changeover is assigned a version 

identifier. In one embodiment, the version identifier, also referred to as a checkpoint identifier, 
is an integer that changes by being incremented with each content update. The web server 
interface intercepts web page requests based on the version expected by the browser, and 
provides the content for that version. To do this, the web server needs to know the version that is 
10 desired by the browser. In one embodiment, this information is included in the URL. However, 
this has the disadvantage of making the URLs and file structure more complicated. Also, the 
version change is less transparent to the user. 
□ In one embodiment, the web server issues a cookie to a browser that includes a version 

;:s. 

Q identifier that specifies the then-current version of the pages served by the server to that browser. 
JflS A cookie is a special text file that a web server sends to a browser so that the web server can 

Li i 

Q "remember" something about that browser. Using the Web f s Hypertext Transfer Protocol 
\i (HTTP), each request for a Web page is independent of all other requests. For this reason, 

without a mechanism such as a cookie, the web server has no knowledge of what pages it has 
sent to a browser previously or anything about the browser's previous visits. A cookie is a 
jj;20 mechanism that allows the server to store its own information about a browser on the browser's 
j J own computer, and access that information when the user makes a web page request. Cookies 
can be provided with an expiration duration, meaning that they will be discarded by the browser 
after a period of time. 

In one embodiment, an example of such a cookie is implemented as the code: "Set- 
25 Cookie: AtreveBCD=37; expires-Thursday, 20-January-1999 12:32:34 GMT; path=/" This code 
is sent from the web server to the browser. The browser will, when communicating with web 
servers in the same domain, include the line "Cookie: AtreveBCD=37" for all requests to any 
path, until 12:32:34 GMT, on 20-January-1999. The "Set-Cookie" and "Cookie" parts of the 
protocol are headers according to the HTTP specification. The "AtreveBCD" is the name of the 
30 cookie. Any other name can be used; AtreveBCDis the default. The "37" is the value of the 
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cookie, which is the checkpoint that the server has now, and will (because of the web server 
interface) continue to offer until the expiration time. The code "Expires" sets that expiration 
time. In the example, the expiration time is 20-January-1999. The "Path" code can be used to 
limit which pages give the cookie, but the "/" indicates it that it will cover all files. 
5 The cookie that the web server issues to the browser effectively allows the browser to 

request content from the web server and indicate the version identifier for that content. Thus, if 
the browser makes six requests with a particular cookie specifying a particular URL, those six 
requests thus will be self-consistent, even if the agent has in the meantime delivered new 
version(s) of content to the web serverl02. 
10 In one embodiment, the earlier content is not discarded until all cookies that specify that 

content have been discarded. The content is stored in a "backup area" which contains the 
changes from a version to the next version. For example, the files that change in a transition 

□ from version 2 to version 3 will be stored in the version 2-3 backup area. The web server 

i ; j interface will direct web page requests for version 2 that changed in the transition from version 2 
;; ";45 to version 3 to the appropriate content in the appropriate backup area. 

□ Referring to FIG. 8, in a simplified example, a web server has content with a current 
%\ version identifier of 34. Previous versions for which cookies are still valid are versions 33 and 
-!L 32. The current version, version 34, contains files A and B, which were modified in version 34; 
pil file C, which was modified in version 28; and file D, which was modified in version 25. File A 
ij;20 was modified in every version shown in the figure, including version 32, version 33, and version 
: :=i 34. File B was modified in version 30, version 32, and as stated above, in version 34. The 

change from version 31 to version 32 thus included changes to files A and B, and deletion of file 
E, which was created in version 1 . Therefore, in the 3 1-32 backup area, which contains the files 
that changed in the transition from version 3 1 to version 32, is version 3 1 of file A, version 30 of 

25 file B, and version 1 of file E are stored. The change from version 32 to version 33 included 
modification of file A, so in the 32-33 backup area, version 32 of file A is stored. The change 
from version 33 to version 34 included modification of files A and B, and deletion of file F 
(which was added in version 10), so in the 33-34 backup area are stored version 33 of file A, 
version 32 of File B, and version 10 of file F. 

30 If a web server requests content, for example by presenting a cookie that indicates a 
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content version other than the current version, and if that file was changed between that older 
checkpoint and the current one, the web server interface may direct the web server to take the 
content from an area other than the current version area. In one embodiment, the web server 
interface reviews the change lists to determine if the requested file has changed, and if it has 
5 changed, what backup area it is located in. For example, still referring to the example of FIG. 8 
in which the current version is version 34, if the web server receives a request for file A, and the 
cookie indicates that the browser is looking for version 32, the web server interface will see that 
file A was modified as part of version 33. Version 32 of file A therefore is located in the 32-33 
backup location. If the web server receives a request for file B from the same browser (with the 
10 same version 32 cookie), the web server interface will determine that file B changed for version 
34, and so version 32 of file B is stored in the 33-34 backup area. If the web server receives a 
request for file D, the web server interface will determine that the file has not been modified 
□ since version 32, and that file can be obtained from the current version area, 
y In one embodiment, the content distributor provides for scheduled updates of source file 

;:: ■ j5 set changes to a particular time or time interval. The content distributor can also update upon a 
j'«* s manual command of the system operator. In one embodiment, the update is specified by: a 
•%1 content mapping indicating where files should be copied from (i.e. the source file set) and where 

they should be copied to (i.e. the file servers 5 file systems); a start/date time or time interval 
g 1 indicating when the update should take place; whether only the changed files should be updated 
U;E0 (as described above) or whether all files should be copied; the action that should be taken upon a 
?i I failure; whether the server should be restarted upon content update; whether the server should be 
paused or stopped during the content update; whether the update is enabled or disabled (to allow 
the system operator to disable a scheduled update); and the percentage of servers that need to 
accept the update before the servers will be instructed to make the change. In one embodiment, 
25 the update is referred to as a job. 

For example, it is possible to specify an update that runs every ten minutes, updates the 
files that have changed, and notifies a system operator of any problems. It is also possible to 
specify an update once a month. In one embodiment, the system turns off the servers while 
copying the files, updates all the changed files and restarts the servers when the content has been 
30 updated. 



Referring to FIG. 9, some web service systems 90 have one or more associated caching 
servers 200. A caching server 200 is a type of web server that is located between the requester 
201 (for example, a browser) and the web service system 90. The caching server 200 initially 
does not have any content. Rather, it requests web pages upon demand from the requester 201 
5 and stores the web pages in its cache. One example of a commercially available caching server 
is the NETCACHE product available from Network Appliance, Inc. of Santa Clara, California. 
The caching server 200 receives a web page request from a browser 201 for content located in 
web service system 90. Based on the request and its own configuration, the caching server 200 
requests the web page from the original web server (web service system 90) that has the web 
10 page. The caching server 200 receives the web page from the original web server 90, and 

transmits the web page to the browser 201 . The caching server 200 also stores that web page for 
a predetermined period of time. The period of time for which the page is stored is a time period 
□ determined by either the content provider (the original web service system 90) by, for example, 
i j j specifying an expiration period with the delivery of the document according to the HTTP 
i: ::j5 protocol, or by the caching server 200 system administrator. If a second request, from the same 
requester 201 or a different requester, arrives at the caching server 200 for that web page within 
%\ the expiration period, the caching server can retransmit the web page in response to the request 
L : without making requesting the content from the original server. Thus, the request is fulfilled 

without placing further demands on the original server or the network with the second request. 
: j;20 When files change on the web service system 90, as described above, files cached on the 

caching server 200 may not have expired. In that case, the caching server 200 continues to 
provide an earlier version of a web page than the updated version that is available from the web 
service system 90. It is therefore useful to use change lists, such as those described above, to 
notify a caching server 200 that files have changed. 
25 Referring to FIG. 10, in a system in which file changes are coordinated with a caching 

server 200, changes are made to files (STEP 180), changes are identified (STEP 181), changes 
are transmitted (STEP 182) to the web servers, and changes are installed (STEP 183). A caching 
server is also notified (STEP 184) of the changes. The additional step of notifying the caching 
server (STEP 184) allows the caching server to disregard (i.e. flush) the obsolete web page. 
30 There can be one caching server, or many caching servers, and they can be notified using various 



communication techniques. For example, in one embodiment, a broadcast message is used. In 
another embodiment a separate message is transmitted to each caching server. In yet another 
embodiment, a file is stored in a directory available to one or more caching servers. 

Referring to FIG. 1 1, an embodiment of the method of FIG. 6 can include making the 
5 changes (STEP 1 80) identifying the changes (STEP 1 8 1 ), and notifying the cache (STEP 1 84). 
In one embodiment, the notification (STEP 184) includes converting the^hange list to Uniform 
Re source Locato rs,("URL") to identify content (STEP 186). Browsers use URLs to identify 
contents As described above, in one embodiment, the change jists a re described in terms of 
I directories and files in Jhe,hostJil^system , because this is more conven ient for We b Servers and 
10 a llowsjndication o f all files in the most file system. When providing changes to a caching 
server, it is useful to convert the change list that lists files (and directories) in^aformat that 
incl udes the URL I U^pos^ corresponds to a particular prefix of 

y possible URLs. For example, the content directory and file 
Q "C:\WEBSPECTIVE\HOME\ABOUT.HTML ,5 might correspond to the URL 
; T Jl5 "http://www.webspective.com/home/about.htmr'. This implies that the prefix would have to be 
j » J modified (in this case C:\WEBSPECTIVE replaced with http://www.webspective.com), and the 
-J directo ry sepam tor^int his case the backslash "\" replaced with the URL.standard forward slash 
j "/". In addition, characters which are not allowed in URLs, such as spaces, are encoded 
l^f according to a specified rule. An example of such character replacement is described in the IETF 
ij;20 Network Working Group RFC- 1783 document entitled "Uniform Resource Locators" by T. 
3 Berners-Lee et al. For example, spaces can be encoded with "%20", and this translation 
concatenated onto the URL prefix. 

Once the list items have been converted into URL format, the list of altered URLs is sent 
to the caching server (STEP 187). The caching server can use this list to discard outdated 
25 content. As shown in FIG. 7, it is not necessary to perform content propagation to perform the 
notification. For example, even if there is only one web server, but many caches, the system of 
FIG. 7 will serve to notify one or more caching servers of the changes. As shown in FIG. 7, the 
changes are made (STEP 180), the changes are identified (STEP 181), and the list of changes are 
then converted to URLs (STEP 1 86). Those changes are transmitted to the caching server (STEP 
30 1 87). In another embodiment, the conversion to URLs (STEP 1 86) takes place between the time 
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that the changes are made (STEP 180) and the change identification step (STEP 181). 
y< Referring to FIG. 12, in one embodiment, method of FIG. 3 and FIG. 10 further includes 
/ running a user configurable script. After changes are made (STEP 1 80), the user configurable 

script is run (STEP 280). After changes are identified (STEP 181), the user configurable script is 
5 run (STEP 281). The script runs simultaneously with the transmission of the changes (STEP 
1 82). After changes are transmitted (STEP 1 82), the user configurable script is run again (STEP 
282). The user configurable script can be used to accomplish content distribution tasks that are 
specific to a customer's implementation. The user configurable script is run through the 
appropriate call to an operating system function. 
10 Referring to FIG. 13, in one embodiment, information is provided to the callout script. In 

one embodiment, the information is provided to the script on the standard input. In another 
embodiment, the information is provided in a file. The script returns either a successful (zero) 
1 status code, or a non-zero error code, which in one embodiment will abort the operation, 
i In one embodiment, the information 400 is provided in a text format, beginning with a 

15 BEGINP ARAMS statement 401 , and ending with an ENDP ARAMS statement 420. The 
information 400 includes the version number 402 of the information block, which is used for 
compatibility. The information 400 includes the name of the job 403, which in this example is 
EXAMPLEJOB. 

The information 400 includes the state of the job 404, which can be one of BEGIN, IN 
I>0 PROGRESS, and END. A BEGIN value indicates that the script is called before the changes are 
identified (i.e. STEP 280 of FIG. 11). An IN PROGESS value indicates that the script is called 
after the changes are identified, but before (or as) the changes are transmitted (i.e. STEP 281 of 
FIG. 1 1). An END value indicates that the transmission is complete (i.e. STEP 282 of FIG. 11). 
The information 400 includes the name of the mapping 405, which in this case is ALLIMAGES. 
25 The information 400 includes the path name of the manifest file 406, which in this example is 
/TMP/STAGING/23423 .TXT. In the example, the manifest is a text file, which implies that it is 
in the text embodiment described above. In one embodiment, the manifest is stored in the binary 
embodiment, as is converted to a text file before the script is called. 

The information 400 includes the source file set directory 406, and a revert directory 408, 
30 which can hold an earlier version of files (before changes), or can contain any content that should 



be automatically reverted to. An array of destinations 409 is indicated. Each array element 
includes information about a destination for the files. In this example, there are two destination 
hosts, OOLONG and DARJEELING. The first element of the array begins with a 
BEGINELEMENT statement 410 and ends with an ENDELEMENT statement 414. The array 
5 element includes the name 41 1 of the destination host, which in this case is OOLONG. The 
array element includes the destination directory 412 on the destination host, which in this 
example is /HOME/HTTPD-OOLONG/DOC/IMAGES. The array element includes the state of 
the transfer 413, which in this example is NORMAL. The second element of the array begins 
with a BEGINELEMENT statement 415 and ends with an ENDELEMENT statement 419. The 
10 second array element includes the name 416 of the destination host, which in this case is 

DARJEELING. The array element includes the destination directory 417 on the destination host, 
which in this example is /HOME/HTTPD-DARJEELING/DOC/IMAGES. The second array 
Q element includes the state of the transfer 418, which in this example is NORMAL. Thus the 
l t i I information provided to the user script allows the same script to be called at different times 
: ^?15 during the execution of a job, and the script can take different actions depending on the 
O parameters provided. 

\J Variations, modifications, and other implementations of what is described herein will 

! "■• -h occur to those of ordinary skill in the art without departing from the spirit and the scope of the 

invention as claimed. Accordingly, the invention is to be defined not by the preceding 
i:j;j20 illustrative description but instead by the spirit and scope of the following claims. 
:7i What is claimed is: 



